home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / gt_power / fmail310.zip / FASTMAIL.DOC < prev    next >
Text File  |  1991-02-27  |  18KB  |  411 lines
  1.  
  2.  
  3.  
  4.                         FASTMAIL - A DOOR for GT Systems
  5.  
  6.  
  7.         REVISION HISTORY.
  8.  
  9.     5/10/90 - BETA #1 - Initial release
  10.  
  11.    10/10/90 - BETA #2 - fix bug when current msg < first msg
  12.                         fix bug on empty area
  13.                         change .OPT file name to avoid conflicts
  14.                         add user option to d/l changed bulletins
  15.                         various cosmetic changes
  16.                         remove spurious messages
  17.  
  18.    11/10/90 - BETA #3 - fixed a nasty memory management problem
  19.                         fixed a bug in the FASTMAIL.CTL update
  20.                         added logging to the GT.LOG
  21.                         added FORCED bulletin options
  22.                         added d/l times
  23.                         added max bag size
  24.                         added keyboard timeout
  25.                         added LOCAL mode - if it is a local logon there
  26.                         will be no file transfer
  27.  
  28.    15/10/90 - BETA #4 - added "novice screen" to display settings
  29.                         (unless the user in in EXPERT mode in GT)
  30.                       - improved the error reporting - runtime errors
  31.                         are now logged to STDOUT
  32.                       - fixed a problem with the PRIVATE ONLY message
  33.                         areas (those with the $ in the GTMDIR.BBS)
  34.                       - fixed a couple of minor cosmetic problems
  35.  
  36.    18/10/90 - BETA #5 - FASTMAIL now uses a SPECIFIC directory name for
  37.                         work files - this help save those who don't read
  38.                         the docs from clobbering stuff <grin>.
  39.                       - FASTMAIL also now sets the "read" flag for any
  40.                         messages addressed TO the user
  41.  
  42.    15/11/90 - BETA #6 - fixed a problem with the date in the control
  43.                         file (I hope!)
  44.                       - fixed a bug on FASTMAIL-selected areas that had
  45.                         LESS messages than the system maximum (it tried
  46.                         to read message MINUS xxxx!!!)
  47.                       - added support for > 9 PID IDs - this has also
  48.                         meant the NAME of the work directory has changed
  49.                         from F_WORK_x to F_WRK_xx (where xx is the PID
  50.                         number for that node).
  51.                       - added the user name to several screens (mainly
  52.                         to help the SYSOP.
  53.  
  54.    04/12/90 - BETA #7 - Fixed a bug in the user defaults display
  55.                       - Added messages to the Select/Deselect/Reset so
  56.                         you know what it is doing
  57.                       - FASTMAIL now checks that the user has enough
  58.                         time to d/l the mailbag
  59.                       - Added letter commands to the menus
  60.                       - REMOVED the /P and /C command-line options. The
  61.                         defaults are now ZIP and Zmodem.
  62.  
  63.    10/12/90 - BETA #8 - Make message posting INTERNAL
  64.                       - Add NETmail facilities
  65.                       - Add upload/download credits
  66.                       - fix time calculation error
  67.                       - add name display for select/deselect
  68.                       - optimized area scanning
  69.                       - added line # to start L)ist from
  70.                       - add Ctl-Z scan
  71.                       - use screen length as defined in USER.CTL
  72.  
  73.    24/12/90 - BETA #9 - add error logging to GT.LOG
  74.                       - add error report to user
  75.                       - add RESTRICT option to DSZ
  76.                       - add bad file transfer retry
  77.                       - add J option to L)ist
  78.                       - fixed bug in log time
  79.  
  80.    30/12/90 - RELEASE - add Y)our Areas to sel/desel menu
  81.                       - add registration requirement
  82.                       - add area numbers to header (for GTREAD)
  83.  
  84.    22/1/91  - v3.01   - remove LJ command (replaced by Y)
  85.                       - fix bug in that if you upload replies then
  86.                         d/l you would get a large number of dud headers
  87.                         in any area(s) you uploaded replies
  88.                       - add tagline option
  89.  
  90. |  25/1/91  - v3.02   - Change command prompts
  91. |
  92. |  25/2/91  - v3.10   - Fix bug in reply (random failures)
  93. |                     - change access method for reply files
  94. |                     - Change First/Last prompt to Next/Last
  95. |                     - Add extract for ALL personal mail
  96. |                     - add counts to Next/Last message
  97. |                     - add ANSI
  98. |                     - add /M (force mono)
  99. |                     - fix bug in sysop extract
  100.  
  101.                       
  102. ******************************************************************************
  103. *                                                                            *
  104. *             *********  W A R N I N G  W A R N I N G  ********              *
  105. *                                                                            *
  106. *                 THIS PROGRAM RUNS UNDER GT v16.00 *ONLY*                   *
  107. *                                                                            *
  108. ******************************************************************************
  109.  
  110. ******************************************************************************
  111. *                                                                            *
  112. *             *********  IMPORTANT IMPORTANT IMPORTANT ********              *
  113. *                                                                            *
  114. *                 THERE HAVE BEEN A NUMBER OF *MAJOR* CHANGES                *
  115. *                 TO FASTMAIL IN THIS RELEASE.                               *
  116. *                                                                            *
  117. *                                                                            *
  118. *                     PLEASE READ THIS DOCUMENT FULLY!!!!                    *
  119. *                                                                            *
  120. ******************************************************************************
  121.  
  122.         WHAT FASTMAIL DOES.
  123.  
  124.                 FASTMAIL is designed to ease the task of users in reading
  125.                 message areas.
  126.  
  127.                 FASTMAIL scans the message bases defined in the GTMDIR.BBS
  128.                 and extracts any UNREAD mail for the user found in the
  129.                 GTUSER.BBS, collects it into one file, compresses
  130.                 the file, and then initiates the download.
  131.  
  132.                 It also allows users to UPLOAD replies and posts them to
  133.                 the correct areas.
  134.                 
  135.                 ONLY areas that the user has access to are processed
  136.                 and FULL message privacy is maintained.
  137.  
  138.  
  139.                 FASTMAIL fully honours the users session time limit and
  140.                 scheduled events.
  141.  
  142.                 If a file transfer is aborted FASTMAIL allows the
  143.                 user to restart or abort it.
  144.  
  145.                 Aborted file transfers will *NOT* update the "last
  146.                 read" pointers or log the transfer to the GT.LOG
  147.  
  148.                 All the files sent to/from FASTMAIL are pure ASCII.
  149.  
  150.                 FASTMAIL uses the GT "last read" pointers. This means
  151.                 you can renumber/delete messages without affecting the
  152.                 operation of FASTMAIL.
  153.  
  154. |               Version 3.10 onwards supports ANSI colour - the colours
  155. |               are determined by the GT.LOG.
  156. |
  157. |               Version 3.10 onwards also allows a user to extract ALL
  158. |               mail addressed to him in an area even though he may
  159. |               only be extracting a few messages. See the FASTHELP.BBS
  160. |               for full details.
  161.  
  162.         PROGRAM REQUIREMENTS AND LIMITATIONS.
  163.  
  164.                 FASTMAIL expects to find a valid GTPATH= in the environment
  165.                 as well as the GTMDIR.BBS, GT.CNF, GTUSER.BBS, DSZ.COM,
  166.                 SCHEDULE.BBS, and FASTHELP.BBS files in the
  167.                 directory nominated by the GTPATH= variable.
  168.  
  169.                            ********* IMPORTANT ********
  170.  
  171.                 FASTMAIL also uses an environment variable to inform
  172.                 DSZ of the COM port in use!!
  173.  
  174.                 you *MUST* place the statement
  175.  
  176.                 SET DSZPORT=p
  177.  
  178.                 where p is the COM port that GT is using (1,2,3 etc - or
  179.                 if using a NON standard COM port use the portx value -
  180.                 e.g. 03E8,5 - see the DSZ doc for more details)
  181.  
  182.                 in you AUTOEXEC.BAT for FASTMAIL to work correctly!!
  183.  
  184.                            ********* IMPORTANT ********
  185.  
  186.                 FASTMAIL REQUIRES the following programs to be in the DOS path.
  187.  
  188.                 PKARC
  189.                 PKXARC
  190.                 PKZIP
  191.                 PKUNZIP
  192.                 LHARC
  193.                 PAK
  194.                 DWREDIR (part of DOORWAY)
  195.  
  196.                 FASTMAIL has a limit of 200 active message areas
  197.  
  198.                 You *MUST* have a copy of DSZ.COM in your LAN PATH directory
  199.                 (if you have defined one in the GT.CNF).
  200.  
  201.                 If you have NOT defined a LAN PATH then you *MUST* have a
  202.                 copy of DSZ.COM in the directory defined by the GTPATH.
  203.  
  204.         COMMAND-LINE PARAMETERS
  205.  
  206.                 FASTMAIL has NINE OPTIONAL command-line parameters.
  207.  
  208. |               /M - force Monochrome mode,
  209. |
  210. |                    If you use this parameter FASTMAIL will ignore the
  211. |                    GTUSER.BBS and display in Mono only.
  212. |
  213.                 /T - add a tag line.
  214.  
  215.                      If this parameter is specified FASTMAIL will add a
  216.                      simple tagline to each UPLOADED message to identify
  217.                      it as coming from an offline source. The tagline is
  218.  
  219.                      ##FASTMAIL vx.yy
  220.  
  221.                      where x.yy is the version of FASTMAIL used.
  222.  
  223.                 /Cxx:yy  - Upload credit parameters.
  224.  
  225.                          This parameter can be used to "reward" those
  226.                          users who participate in the message areas by
  227.                          using FASTMAIL.
  228.  
  229.                          It will MULTIPLY the Kbytes of UPLOADED mail
  230.                          (i.e. replies) by the value of xx and will
  231.                          DIVIDE the Kbytes of DOWNLOADED mail by the
  232.                          value of yy and add these together to give a
  233.                          "credit" Kbytes which is added to the users
  234.                          Upload Kbytes in the USER.CTL.
  235.  
  236.                          as an example using the parameter /C05:10
  237.  
  238.                          If the user uploaded 3k of replies and
  239.                          downloaded 200k of mail, FASTMAIL would
  240.                          multiply the 3k by 5 (giving 15k) and divide
  241.                          the 200k by 10 (giving 20k). This would give a
  242.                          total of 35k which is then added to the
  243.                          USER.CTL upload Kbytes.
  244.  
  245.  
  246.                 /Lxxxx - Maximum numbers of messages per area.
  247.  
  248.                          Specifies the maximum number of messages
  249.                          to extract from EACH message area. If not
  250.                          specified defaults to 50 messages.
  251.  
  252.                 /D  - DOORWAY Mode.
  253.  
  254.                       If you are running FASTMAIL via DOORWAY you *MUST*
  255.                       add the /D parameter otherwise your DSZ transfers
  256.                       will fall over in a BIG way!!
  257.  
  258.                 /B  - Force bulletins.
  259.  
  260.                       If this parameter is used FASTMAIL will ALWAYS
  261.                       include changed bulletin files.
  262.  
  263.                 /Q  - Quiet mode.
  264.  
  265.                       If specified this parameter causes FDASTMAIL NOT to log
  266.                       to the GT.LOG.
  267.  
  268.                       The default IS to log FASTMAIL files transfers to
  269.                       the GT.LOG.
  270.  
  271.                 /Sxxx - Maximum mailbag size.
  272.  
  273.                       If specified this sets the maximum COMPRESSED file
  274.                       that a user can transfer in a session. The size is
  275.                       specified in Kbytes.
  276.  
  277.                       If NOT specified there is NO limit on the maximum
  278.                       mailbag size.
  279.  
  280.                 /Kxxx - Keyboard timeout.
  281.  
  282.                       This specifies a keyboard timeout (in minutes).
  283.  
  284.                       If NO key is struck within this time FASTMAIL will
  285.                       return to the BBS.
  286.  
  287.                       The default is 5 minutes.
  288.  
  289.                       This timeout was added to counter a nasty trap
  290.                       when using DOORWAY - it seems that DOORWAY was
  291.                       being a little too smart for its own good!
  292.  
  293.                       If you were doing a DSZ transfer and the carrier
  294.                       was lost DOORWAY would quite correctly terminate
  295.                       DSZ - BUT LEAVE FASTMAIL RUNNING WITH CARRIER
  296.                       MONITORING DISABLED!!
  297.  
  298.                       Without the timeout FASTMAIL would sit there
  299.                       FOREVER waiting for a key.
  300.  
  301.         ERRORLEVEL EXITS.
  302.  
  303.                 FASTMAIL uses the DOS errorlevel to indicate any
  304.                 problems that may arise.
  305.  
  306.                 If you are using DOORWAY this will reflected in the
  307.                 DWSHELL.ERR file.
  308.  
  309.  
  310.                 All errors EXCEPT 1, 9 or 14 are reported in
  311.                 the GT.LOG.
  312.  
  313.  
  314.                     ERRORLEVEL           MEANING
  315.  
  316.                        1            No GTPATH found
  317.                        2            Error accessing GTUSER.BBS
  318.                        3            Error accessing USER.CTL
  319.                        4            Error accessing GTMDIR.BBS
  320.                        5            Error accessing MESSAGE.CTL
  321.                        6            Error accessing USER_MSG.CTL
  322.                        7            Error accessing a .MES file
  323.                        8            Error accessing FASTMAIL.CTL
  324.                        9            Error accessing GT.CNF
  325.                       10            Error accessing MAILxxxx.TXT
  326.                       11            Error accessing SCHEDULE.BBS
  327.                       12            Error deleteing files
  328.                       13            Error accessing bulletins
  329.                       14            Error accessing GT.LOG
  330.                       15            Keyboard timeout
  331.                       16            No F_WRK_xx directory found
  332.                       17            Error executing DSZ.COM
  333.  
  334.         CONTROL FILES.
  335.  
  336.                 FASTMAIL has ONE control file - the FASTMAIL.CTL.
  337.  
  338.                 This file is created/maintained by FASTMAIL in either
  339.                 the LAN path or GT path.
  340.  
  341.                 Do NOT "fiddle" with this as it used to keep the default
  342.                 settings for each user of FASTMAIL!
  343.  
  344.         USING FASTMAIL.
  345.  
  346.                 Please see the enclosed .BAT for a DOOR file
  347.                 to run FASTMAIL - you shouldn't have to change much
  348.                 (if anything!) the run it (apart from changing the
  349.                 name of the .BAT to GTDOORxx.BAT)
  350.  
  351.  ********* YOU MUST HAVE A SPECIAL WORKING DIRECTORY FOR FASTMAIL ********
  352.  
  353.                The working directory for FASTMAIL *MUST* be unique
  354.                as FASTMAIL itself will delete ANY files found in it!!
  355.  
  356.                FASTMAIL uses a FIXED DIRECTORY NAME.
  357.  
  358.                This name is F_WRK_xx where xx is the PID number (as
  359.                defined by the LN= parameter of the GT.CNF). If NO LN=
  360.                parameter is found xx defaults to 0.
  361.  
  362.                xx *MUST* be 2 digits (00-32)
  363.  
  364.                THIS DIRECTORY *MUST* EXIST - FASTMAIL will NOT create
  365.                it.
  366.  
  367.                You only have to change to the correct DRIVE (i.e.
  368.                the drive where the FASTMAIL working directory(s) are
  369.                located).
  370.  
  371.         REGISTRATION.
  372.  
  373.                FASTMAIL is an OZnet package and therefor requires a CRC
  374.                to be installed to enable all functions.
  375.  
  376.                If FASTMAIL is *NOT* registered you will not be able to
  377.                upload replies, and FASTMAIL will not keep track of the
  378.                users "last read" pointers.
  379.  
  380.                For registration details please see the enclosed
  381.                "readme.now" file.
  382.  
  383. |              It does NOT cost anything to register this program, but
  384. |              if you like FASTMAIL a donation would be appreciated!
  385. |
  386. |              The easiest method would be to send me a NETMAIL message
  387. |              with your Visa/Mastercard details and what YOU think the
  388. |              program is worth.  Please note that I can ONLY accept
  389. |              Visa or Mastercard from locations outside Australia as it
  390. |              costs me $6 to have a foreign cheque cashed!
  391.  
  392.                
  393.         FURTHER INFORMATION.
  394.  
  395.                 May be obtained from the author -
  396.  
  397.                            Ken Thompson
  398.                            164 Lyons Rd.
  399.                           Drummoyne N.S.W.
  400.                        Sydney Australia 2047
  401.                           +61-2-81-4751
  402.  
  403.                  or I may be contacted via my BBS
  404.  
  405.                          The Black Hole
  406.                       GT Net/Node 302/003
  407.                       Modem  +61-2-719-8161
  408.                       Modem  +61-2-719-8491
  409.                       Modem  +61-2-719-8304
  410.  
  411.